home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / comm / bbs / PMBSList0222.lha / anleitung.txt next >
Text File  |  1995-05-28  |  9KB  |  253 lines

  1. ================================== ANMERKUNG ============================
  2.  
  3. Diese Anleitung ist für die Beta-Version von PMBSList und keinesfalls
  4. vollständig!
  5.  
  6. Ebenso ist das Programm noch nicht bis in alle Einzelheiten ausgetestet,
  7. es kann also noch zu Fehlern führen, obwohl ich mich bemüht habe, alle
  8. nur denkbaren Fehlerquellen zu beseitigen!
  9.  
  10. =========================================================================
  11.  
  12. Versionsgeschichte:
  13.  
  14.   V0.222 - 28-May-95
  15.  
  16.          - Bugfix: Meldung 'Keine (Binär-)Uploads' in ASCII/BIN-Brettern
  17.  
  18.            Bei Brettern, die gleichzeitig das ASC und das BIN-Flag
  19.            gesetzt hatten, kam die o.a. Meldung allerdings ohne daß der
  20.            Brettname vorher ausgedruckt wurde
  21.            Dieser Fehler wurde entfernt
  22.  
  23.          - neue Option: BildschirmLöschen=ja/nein [alle Modi]
  24.  
  25.            Mit dieser Option kann angegeben werden, ob am Anfang der
  26.            Liste ein Bildschirm-Löschcode (\f) eingefügt werden soll
  27.            (für TMS@DAME.shnet.org :-)
  28.  
  29.          - neue Option: TageKorrigieren=ja/nein [MODUS=neu]
  30.  
  31.            "mißbraucht" man den Neu-Modus zum Erstellen einer kompletten
  32.            Fileliste in dem man den Tage= Parameter auf einen Wert setzt,
  33.            der größer als das Alter der Box ist, so wurde für die Zeile
  34.            xxx Uploads ( yyy Uploads pro Tag) dieser Tage= Parameter
  35.            für die Berechnung des yyy herangezogen.
  36.            Mit TageKorrigieren=ja wird jetzt zur Berechnung des yyy die
  37.            Zeitspanne zwischen dem ältesten Upload und dem Erstellungs-
  38.            Datum (jetzt) der Liste herangezogen, was der Wahrheit in
  39.            diesem Fall sehr viel näher kommt.
  40.  
  41.            Für eine "richtige" Neue-Uploads-Liste (z.B. der letzten 4
  42.            Tage), sollte TageKorrigieren=nein sein, denn wenn am ersten
  43.            dieser 4 Tage nichts geuppt wurde, muß das natürlich dennoch
  44.            in die Berechnung einfliessen.
  45.  
  46.            Alles verstanden ? :-)
  47.  
  48.  
  49.   V0.217 - 20-May-95
  50.  
  51.          - neue Option: Text=links/rechts
  52.            In der Top-Download-Liste kann der Brettname jetzt links oder
  53.            rechts-"endig" angezeigt werden, also wahlweise die ersten
  54.            oder die letzten 33 Zeichen des Brettnamens, reichen diese 33
  55.            Zeichen nicht aus, so wird mit drei Punkten (...) angedeutet,
  56.            daß der Brettname länger ist, als in diesem Feld angezeigt.
  57.  
  58.          - Fehler in der SupportLib behoben, in der Brettliste
  59.            können nun auch Leerzeilen auftauchen
  60.  
  61.          - neue Option: Leermeldung=ja/nein
  62.            Bei 'Leermeldung=ja' werden Bretter nur noch in die
  63.            Neue-Upload-Liste eingetragen, wenn es dort mindestens
  64.            einen Upload gegeben hat
  65.  
  66.          - neue Option: Sortierung=neu/alt
  67.            Neue-Uploads-Liste kann jetzt wahlweise neu->alt oder alt->neu
  68.            sortiert werden
  69.  
  70.  
  71.   V0.208 - 15-May-95
  72.  
  73.          - Bei der Top-Download-Liste wird jetzt die Anzahl der Zugriffe
  74.            beim vorigen Aufruf von PMBSList angezeigt, d.h. man kann die
  75.            Veränderungen der Zugriffszahl erkennen.
  76.            Diese Werte werden in der Datei, die im Ini-File unter "Daten="
  77.            gespeichert, fehlt dieser Parameter wird automatisch die Datei
  78.            "prometheus:Daten/toplist.dat" erzeugt
  79.  
  80.          - zusätzliche Meldungen im Meldungsfenster, so daß man besser
  81.            erkennen kann, woran das Programm gerade arbeitet
  82.  
  83.          - am Anfang der Neue-Upload-Liste wird jetzt ein ClearScreen-
  84.            Code (\f) eingesetzt
  85.  
  86.  
  87.   V0.184 - 14-May-95
  88.  
  89.            Zwei Compiler(?)-Bugs umgangen, beim "Tage"-Parameter wurden
  90.            größere Zahlen (>= 600 oder so...) nicht richtig in einen
  91.            Long-Wert konvertiert, daher lieferte der Neu-Modus da
  92.            unvollständige Listen (Danke an SYSOP@DAME.shnet.org für
  93.            die Feststellung)
  94.  
  95.            neue Option "Farbe=ja/nein" - Liste mit oder ohne Farben
  96.            erzeugen
  97.  
  98.  
  99.   V0.181 - 04-May-95
  100.  
  101.            erste veröffentlichte Version
  102.  
  103. =========================================================================
  104.  
  105. Anleitung für PMBSList V0.222 vom 28.05.95:
  106.  
  107. PMBSList soll ein universelles List-Tool für Prometheus werden.
  108.  
  109. Zwei Funktionen sind bis jetzt realisiert:
  110.  
  111.   1) Erzeugen einer Top-Download-Liste, d.h. es können die beliebtesten
  112.      Files einer Box angezeigt werden
  113.  
  114.   2) Erzeugen einer Neuen-Upload-Liste, d.h. es können die neuen Files
  115.      in einer Box angezeigt werden
  116.  
  117.      (durch geschicktes Angeben des Tage= Parameters und der anderen
  118.      Optionen, kann man diesen Modus nutzen um eine komplette File-
  119.      Liste der Box zu erstellen!)
  120.  
  121. Alle Funktionen sind in einem Programm, nämlich PMBSList (ach was :-)
  122. realisert und können über eine Konfigurations- (Ini-) Datei gesteuert
  123. werden, die vielfältig konfiguriert werden kann.
  124.  
  125. PMBSList läuft mit einer Taskpriorität von -1, d.h. während der
  126. Erzeugung einer Liste kann in der Box normal weitergearbeitet werden!
  127.  
  128.  
  129. Installation:
  130.  
  131.   PMBSList sollte unter dem Namen PList in ein Verzeichnis im Suchpfad
  132.   kopiert werden (am besten nach C:).
  133.  
  134.   Der kurze Name und der Suchpfad sind von entscheidender Bedeutung,
  135.   wenn es darum geht, PMBSList im Prometheus-Zeitplan aufzurufen, wo
  136.   Martin Brückner, der Programmierer von Prometheus gerade einmal
  137.   35 Zeichen für das Kommando samt seiner Parameter vorgesehen hat :-(((
  138.  
  139.   Im Prometheus-Verzeichnis sollten dann die Ini-Dateien installiert
  140.   werden, je nachdem, welchen Modus man benutzen will, die TopList.ini
  141.   oder die NeuList.ini oder beide.
  142.  
  143.   Mit Hilfe des mitgelieferten Tools ListProBretter muß dann eine
  144.   ASCII-Text-Liste (!) der Brettliste erzeugt werden. Danach löscht
  145.   man mit einem Editor die für die Liste unerwünschten Bretter aus
  146.   dem Text und speichert ihn unter Prometheus:pmbslist.lst ab.
  147.   Oberbretter, also Bretter, die selbst keine Files enthalten, sollte
  148.   man löschen, damit spart sich das Programm, in diesen Verzeichnissen
  149.   nach Indexfiles zu suchen!
  150.  
  151.   ListProBretter schreibt auf die Standardausgabe, mit > kann die
  152.   Brettliste in eine Datei geschrieben werden, am besten man gibt
  153.   hier gleich an: ListProBretter BIN >prometheus:pmbslist.lst
  154.  
  155.   ListProBretter versucht, die Datei prometheus:daten/brett.dat zu
  156.   lesen, hat man eine andere Brettliste, so kann man den Namen
  157.   wie folgt an ListProBretter mitgeben: ListProBretter FILE=filename
  158.  
  159.  
  160.   Aufgerufen wird PMBSList (oder PList, wenn man es so genannt hat)
  161.   am Besten im Zeitplan, und zwar sieht das dann in etwa so aus:
  162.  
  163.     00:05 DOSC plist config=prometheus:top.ini
  164.     00:10 DOSC plist config=prometheus:neu.ini
  165.  
  166.   (nicht vergessen, die 1. Zahl im Zeitplan entsprechend der
  167.   angefügten Zeilen zu vergößern!!)
  168.  
  169.   Zu den angegebenen Zeiten wird nun eine Liste erzeugt und zwar
  170.   um 00:05 die Top-Download-Liste und um 00:10 die Neue-Upload-Liste!
  171.  
  172.   Lt. eigener Aussage von M. Brückner, dem Programmierer von Prometheus
  173.   sollte man keine Zeiten unter 00:05h eingeben, den Grund hat er
  174.   allerdings nicht genannt :-/
  175.  
  176.  
  177. ---- !!!!!!! -----
  178.  
  179.   Sollte ein User gerade auf die zu erzeugende Liste zugreifen, so
  180.   wird eine (systemfreundliche!) Pause von 60 Sekunden eingelegt, danach
  181.   versucht PMBSList erneut die Liste zu schreiben. Nach 10 erfolglosen
  182.   Versuchen beendet sich PMBSList automatisch!
  183.  
  184. ---- !!!!!!! -----
  185.  
  186.   Nach dem Erzeugen der Neue-Uploads-Liste wird von PMBSList eine
  187.   Online-Message an die gerade eingeloggten User geschickt
  188.   ("SYSTEM: neue Upload-Liste erzeugt um HH:MM!").
  189.   (Für die Top-Files-Funktion ist das noch nicht realisiert!)
  190.  
  191.   In Prometheus muß man jetzt nur noch einen Befehl erzeugen, mit dem
  192.   man die Listen anzeigen lassen kann, z.B.
  193.  
  194.      NAME: TOP FILES!
  195.      BESCHREIBUNG:  die Super-Files dieser Box
  196.      PARAMETER:     prometheus:texte/toplist.txt
  197.      GRUPPE:        (wie gewünscht)
  198.      TYP:           Text
  199.      Shortcut:      3
  200.      Befehl:        markieren
  201.      Extern:        markieren
  202.  
  203.   Analog verfährt man mit der Neuen-Upload-Liste.
  204.  
  205.   Man kann natürlich auch im Login.txt z.B. die Neue-Upload-Liste
  206.   eintragen, in die letzte Zeile sollte dann rein:
  207.  
  208.     #%>prometheus:texte/neulist.txt
  209.  
  210.   Mit ein paar Zusatzparametern kann man noch das Aussehen der Liste
  211.   steuern, bitte dazu die mitgelieferten .ini-Dateien anschauen,
  212.   diese sind kommentiert.
  213.  
  214.   Ruft man PMBSList ohne den CONFIG= Parameter auf, so wird die
  215.   Datei 'pmbslist.ini' im gleichen Verzeichnis wie PMBSList gesucht.
  216.  
  217.   Den CONFIG= Parameter kann man auch mit C= abkürzen!!
  218.  
  219.  
  220. Beschränkungen:
  221.  
  222.   In der Beta-Version können z.Zt. in der "Neue-Uploads-Liste" nur
  223.   500 verschiedene Uploader aufgenommen werden, hat man mehr Uploader
  224.   (was allerdings unwahrscheinlich ist), so wird das Programm mit an
  225.   Sicherheit grenzender Wahrscheinlichkeit abstürzen :-)
  226.  
  227.   (Noch mal: Es geht um die Anzahl der VERSCHIEDENEN UPLOADER, also der
  228.    User (!), nicht der Uploads selbst, da ist man nur durch den vorhandenen
  229.    Speicher beschränkt!)
  230.  
  231.  
  232. Support:
  233.  
  234.   Support gibt es vom Programmierer persönlich :-)
  235.   Einfach eine E-Mail an JEFF@DAME.SHNET.ORG
  236.  
  237.   Das neueste Update gibts in der
  238.  
  239.      SANCTUARY BBS HAMBURG - +49-(0)40-3901997  (V.42bis)
  240.  
  241.      Login: GAST (kein Passwort)
  242.      Brett: /A0-Amiga/A3-Prometheus
  243.  
  244.   oder in der
  245.  
  246.      NOTRE DAME BBS HAMBURG - +49-(0)40-2800074  ZyXEL EG 19.2
  247.                             - +49-(0)40-247816   ACTiVE 28.800
  248.                             - +49-(0)40-28050032 ISDN X.75
  249.  
  250.      Login: GAST (kein Passwort)
  251.      Brett: /<---SUPPORT--->/JEFFS_PROMETHEUS-TOOLS
  252.  
  253.